home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / music / delitracker_1.36 / docs / delitracker.doc next >
Text File  |  1994-11-17  |  54KB  |  1,399 lines
  1. ***************************************************************************
  2. *                               DeliTracker                  *
  3. ***************************************************************************
  4.  
  5.                             © 1992 by Delirium
  6.                          $VER: V1.36 (07.01.1993)
  7.  
  8.  
  9.  
  10. 1. CONTENTS
  11.  
  12.         1.CONTENTS
  13.  
  14.         2.LICENSING AND DISTRIBUTION
  15.  
  16.         3.INTRODUCTION
  17.           3.1 What is DeliTracker ?
  18.           3.2 Why use DeliTracker ?
  19.  
  20.         4. GETTING STARTED
  21.           4.1 System requirements
  22.           4.2 Starting from CLI/Shell
  23.           4.3 Starting from Workbench
  24.           4.4 Installation
  25.  
  26.         5. BASICS
  27.           5.1 Player 
  28.           5.2 Packed modules
  29.           5.3 Options
  30.           5.4 Configuration files
  31.  
  32.         6. HOW TO CONTROL DELITRACKER
  33.           6.1 The main window
  34.             6.1.1 Gadgets 
  35.             6.1.2 Menus
  36.             6.1.3 Shortcuts 
  37.         6.1.4 Appwindow
  38.           6.2 The preferences window
  39.             6.2.1 Gadgets 
  40.             6.2.2 Shortcuts 
  41.           6.3 ARexx 
  42.       6.4 Commodities
  43.  
  44.         7. TROUBLESHOOTING
  45.  
  46.     8. EXTERNAL PLAYER PROGRAMMING INTERFACE
  47.       8.1 The external player interface
  48.         8.1.1 The structure of external players
  49.         8.1.2 The structure of custom modules
  50.       8.2 How to build external players
  51.         8.2.1 Playerheader
  52.         8.2.2 Modulerecognicion
  53.         8.2.3 Interrupts
  54.       8.3 Tags
  55.       8.4 DeliTracker support functions
  56.       8.5 Hints and Tips
  57.  
  58.         9. ACKNOWLEDGEMENTS
  59.  
  60.  
  61.  
  62. 2. LICENSING AND DISTRIBUTION
  63.  
  64.        DeliTracker (c) 1991 - 1993 by Peter Kunath and Frank Riffel.
  65.  
  66.   This Program is Shareware. If you like this program and use it
  67.   frequently, we encourage you to register. The shareware fee is $US 20
  68.   or 20 DM. You may send CASH or EUROCHEQUE's. We cannot accept any other
  69.   cheques cause it is not possible for us to cash foreign checks without
  70.   having to pay substantial fees to the bank. Registered users will be
  71.   shipped a disk with the latest release version of DeliTracker. By
  72.   cooperating with this concept you help to ensure continued development
  73.   of this product. Please send your registration card (Orderform) and
  74.   the money to:
  75.  
  76.                                Frank Riffel
  77.                                 Merkstr. 27
  78.                               8129 Wessobrunn
  79.                                   Germany
  80.  
  81.  
  82.   You may send bug reports, remarks, and suggestions to this address as
  83.   well. If you have written a new soundsystem and you wish to adapt your
  84.   replay-routine to DeliTracker, contact us. We will help you.
  85.  
  86.   DeliTracker may be distributed on public-domain, shareware disks, and
  87.   electronic networks such as the Internet as longs as the followings
  88.   conditions are fulfilled:
  89.  
  90.     ° all files must be kept together. You can find a list of all
  91.       files in 'Distribution'.
  92.  
  93.     ° no part of the distribution may be changed in any way. The only 
  94.       exception is archiving (e.g. with LhA), but the original files 
  95.       must be 100% restoreable.
  96.  
  97.     ° The price of a disk that contains DeliTracker must be less than 
  98.       US $6 or 8.- DM. The same is the maximum price that networks 
  99.       may charge from their users for downloading DeliTracker.
  100.  
  101.     ° For use in commercial products the permission of the authors
  102.       is required.
  103.  
  104.   DeliTracker was developed and tested very carefully. Nevertheless
  105.   the Authors are not responsible for any damages that are caused by
  106.   DeliTracker. Use at your own risk.
  107.  
  108.  
  109. 3.INTRODUCTION
  110.  
  111.   3.1 What is DeliTracker ?
  112.  
  113.   DeliTracker is a soundplayer which supports several soundformats; some
  114.   are SoundTracker 15 inst., SoundTracker 31 inst., NoiseTracker,
  115.   ProTracker, StarTrekker without AM sounds and CustomPlay. Since these
  116.   types are so common, their replay routines are built within DeliTracker
  117.   itself. Additional players are loaded from disk, meaning that you can
  118.   very easily add/update players by placing them into the DeliPlayers
  119.   directory. DeliTracker is NOT a Songeditor, MIDIsequencer or Digitizer.
  120.   It is only meant to play music modules in a comfortable way.
  121.  
  122.   3.2 Why use DeliTracker ?
  123.  
  124.   There are many reasons for using DeliTracker; here is only a small list:
  125.  
  126.         ° system friendly and multitasks happily
  127.         ° allocates the soundchannels
  128.         ° correct playspeed in PAL/NTSC (uses timerinterrupts)
  129.         ° works well with serial.device
  130.         ° supports xpkmaster.library for decrunching
  131.         ° supports up to 64 players
  132.         ° runs fine with 680x0
  133.         ° ARexx support
  134.         ° has a configfile
  135.         ° enforcer and mungwall proof
  136.         ° supports full CLI or Workbench (ToolTypes) environment
  137.         ° easy to use & looks good
  138.         ° has Volume/Balance sliders
  139.         ° resident cli startup
  140.         ° supports multiselect
  141.         ° PubScreen support
  142.         ° hotkey (Commoditiy)
  143.         ° modules can be played by simply dropping the moduleicon into
  144.           the mainwindow (Appwindow).
  145.         ° written in 100% Assembler
  146.  
  147.  
  148. 4. GETTING STARTED
  149.  
  150.   4.1 System requirements
  151.  
  152.   As of version 1.31 and beyond DeliTracker requires at least Workbench 
  153.   and Kickstart 2.0 (aka V37). We recomend the usage of Workbench 2.1 
  154.   (or 3.0), because the ASL Filerequester of V38 and above is much faster
  155.   and supports multiselect. If you want to use packed modules, the 
  156.   'xpkmaster.library' and the corresponding sublibraries must be installed. 
  157.   Make sure that you use V2 of XPK! V1 is NOT sufficient. DeliTracker 
  158.   requires at least 70KB of memory. Additional memory is needed for every
  159.   loaded player, for the current modulelist and the decrunched module. Of
  160.   course your System should be equiped with a Monitor that has speakers or
  161.   even better with a HiFi system.
  162.  
  163.  
  164.   4.2 Starting from CLI/Shell
  165.  
  166.   Open a Shell or CLI window and CD to the directory where DeliTracker is
  167.   located. Now you can type 'DeliTracker' followed by none/one/more options
  168.   explained in 5.4. The options and arguments should be separated by spaces. 
  169.   DeliTracker automatically detatches from the CLI and you may close the 
  170.   CLI window. If a wrong arument is supplied DeliTracker quits with a short
  171.   helptext.
  172.  
  173.   Example: 'DeliTracker config DT.config volume 32 filter 0'
  174.   
  175.   Starts DeliTracker with 'DT.config' as configuration file, turns the
  176.   lowpass filter off (not on A1000's) and sets the volume to 32.
  177.  
  178.  
  179.   4.3 Starting from Workbench
  180.  
  181.   Open the drawer that contains DeliTracker and start it with a double
  182.   click. All options can be set as ToolTypes by using the 'Info' item
  183.   from the Workbench. The options must be separated by an '=' from the
  184.   arguments. Invalid Tooltypes are ignored. DeliTracker can be used as
  185.   a 'Default Tool' for automatic playing of modules.
  186.  
  187.   Example:      Config=DT.config
  188.                 PrefWinXY=0/11
  189.                 Volume=43
  190.                 CX_Popup=NO
  191.  
  192.   If DeliTracker is started with these tooltypes, it loads 'DT.config' as
  193.   the configuration file and sets the volume to 43.
  194.  
  195.  
  196.   4.4 Installation
  197.  
  198.   If you already use an older version of DeliTracker, please delete all
  199.   files of the old distribution and your configuration files before you
  200.   install this version.
  201.  
  202.   Copy DeliTracker in a directory of your choosing. Now copy the whole 
  203.   'DeliPlayers' directory into this place. We strongly suggest that you
  204.   move seldom used players from DeliPlayers/ to DeliPlayers/PlayerStore/. 
  205.   If you don't do this you waste memory! When DeliTracker is started every 
  206.   player in the 'DeliPlayers' drawer will be loaded. Note: any loaded 
  207.   player will stay in memory until the user unloads it or DeliTracker is 
  208.   exited. If you have packed modules you must install the XPK libraries.
  209.   A double click on the CopyLibs icon will launch a script that will 
  210.   install the powerpacker.library and the XPK libraries in LIBS:.
  211.  
  212.  
  213. 5. BASICS
  214.  
  215.   5.1 Player 
  216.  
  217.   With DeliTracker it is possible to load single players. If such a player
  218.   is loaded DeliTracker will recognize and play modules of this type.
  219.   Currently a maximum of 64 external players may be loaded. This should be
  220.   sufficient for awhile. When DeliTracker is started all players in the
  221.   'DeliPlayers' directory or the specified playerpath e.g. tooltypes or in
  222.   the c